Scenario #6010: Replace Deceased Partner by Community of Heirs

Properties

Required

Given

name value
partnerNumber P-31011
dateOfDeath 2024-11-15
representativeGivenName Lena
representativeFamilyName Stadland
communityOfHeirsPostalAddress “street”: “Im Wischer 14”,
“zipcode”: “22987”,
“city”: “Hamburg”,
“country”: “Germany”
communityOfHeirsOfficePhoneNumber +49 40 666666
communityOfHeirsEmailAddress lena.stadland@example.org

Partner: P-31011

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "3a91c028-722c-48dd-bac9-103112001431", // Partner: P-31011 - Michelle Matthieu
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "40c6c87f-3490-42fa-a3f2-fc2fbe748c6f",
    "anchor" : {
      "uuid" : "8f6b2e83-5cd0-4f3b-bac9-c56b374445cf", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "c7b75e67-8032-40b6-a6a3-2cac00ee49af", // personUuid
      "personType" : "NATURAL_PERSON",
      "tradeName" : null,
      "salutation" : null,
      "title" : null,
      "givenName" : "Michelle",
      "familyName" : "Matthieu-Zhang"
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "2f189108-ed7e-4698-88fc-5fc5b29729ef", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "details" : {
    "uuid" : "d1be819c-7338-4af6-9c91-1292df11550e",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Even in production data we expect this query to return just a single result.

New Partner-Person+Contact: Erbengemeinschaft Michelle Matthieu-Zhang

HTTP PATCH "/api/hs/office/partners/3a91c028-722c-48dd-bac9-103112001431" // Partner: P-31011 \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "partnerRel" : {
    "holder" : {
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang"
    },
    "contact" : {
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "whatever" : "any key is allowed here",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "street" : "Im Wischer 14",
        "zipcode" : "22987",
        "city" : "Hamburg",
        "country" : "Germany"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      }
    }
  }
}
EOF
=> status: 200 OK 
{
  "uuid" : "3a91c028-722c-48dd-bac9-103112001431", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "40c6c87f-3490-42fa-a3f2-fc2fbe748c6f",
    "anchor" : {
      "uuid" : "8f6b2e83-5cd0-4f3b-bac9-c56b374445cf", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d",
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612",
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "d1be819c-7338-4af6-9c91-1292df11550e",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang

HTTP POST "/api/hs/office/relations" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }` \
  <<EOF
{
  "type" : "REPRESENTATIVE",
  "anchor.uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
  "holder" : {
    "personType" : "NATURAL_PERSON",
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "contact.uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612" // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
}
EOF
=> status: 201 CREATED e2cbcfd5-9baf-4efa-a565-85c788969a4e
{
  "uuid" : "e2cbcfd5-9baf-4efa-a565-85c788969a4e",
  "anchor" : {
    "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "6c205a8b-7c5f-4f5c-8b80-24f8dafd55f8",
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
}

Verify the Updated Partner

HTTP GET "/api/hs/office/partners/P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
{
  "uuid" : "3a91c028-722c-48dd-bac9-103112001431", // Partner: P-31011
  "partnerNumber" : "P-31011",
  "partnerRel" : {
    "uuid" : "40c6c87f-3490-42fa-a3f2-fc2fbe748c6f",
    "anchor" : {
      "uuid" : "8f6b2e83-5cd0-4f3b-bac9-c56b374445cf", // Person: Hostsharing eG
      "personType" : "LEGAL_PERSON",
      "tradeName" : "Hostsharing eG",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "PARTNER",
    "mark" : null,
    "contact" : {
      "uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
      "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "postalAddress" : {
        "zipcode" : "22987",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "Im Wischer 14",
        "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "co" : "Lena Stadland",
        "whatever" : "any key is allowed here"
      },
      "emailAddresses" : {
        "main" : "lena.stadland@example.org"
      },
      "phoneNumbers" : {
        "office" : "+49 40 666666"
      }
    }
  },
  "details" : {
    "uuid" : "d1be819c-7338-4af6-9c91-1292df11550e",
    "registrationOffice" : null,
    "registrationNumber" : null,
    "birthName" : "Eichbaum",
    "birthPlace" : "Neustadt a.d.R.",
    "birthday" : "1951-03-25",
    "dateOfDeath" : null
  }
}

Verify the Ex-Partner-Relation

HTTP GET "/api/hs/office/relations?relationType=EX_PARTNER&personUuid=c7b75e67-8032-40b6-a6a3-2cac00ee49af" // Person: Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "64c0040f-7dea-4fad-bd11-425cce1a941b",
  "anchor" : {
    "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "c7b75e67-8032-40b6-a6a3-2cac00ee49af", // Person: Michelle Matthieu-Zhang
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Michelle",
    "familyName" : "Matthieu-Zhang"
  },
  "type" : "EX_PARTNER",
  "mark" : null,
  "contact" : {
    "uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Representative-Relation

HTTP GET "/api/hs/office/relations?relationType=REPRESENTATIVE&personUuid=836d3bb3-2eab-48d1-966e-8916a037816d" // Person: Erbengemeinschaft Michelle Matthieu-Zhang \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "e2cbcfd5-9baf-4efa-a565-85c788969a4e", // Representative-Relation: Lena Stadland for Erbengemeinschaft Michelle Matthieu-Zhang
  "anchor" : {
    "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
    "personType" : "UNINCORPORATED_FIRM",
    "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "6c205a8b-7c5f-4f5c-8b80-24f8dafd55f8", // Person: Lena Stadland
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Lena",
    "familyName" : "Stadland"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
    "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
    "postalAddress" : {
      "zipcode" : "22987",
      "country" : "Germany",
      "city" : "Hamburg",
      "street" : "Im Wischer 14",
      "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "co" : "Lena Stadland",
      "whatever" : "any key is allowed here"
    },
    "emailAddresses" : {
      "main" : "lena.stadland@example.org"
    },
    "phoneNumbers" : {
      "office" : "+49 40 666666"
    }
  }
} ]

Verify the Debitor-Relation

HTTP GET "/api/hs/office/debitors?partnerNumber=P-31011" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<hsh-alex_superuser>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "7c56e0a3-6ec3-43eb-8b3a-d7963f0fa3a4", // Debitor: D-3101100 - Michelle Matthieu
  "debitorRel" : {
    "uuid" : "304c9ff0-e600-41dd-a57b-5e14b13976a7",
    "anchor" : {
      "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "holder" : {
      "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
      "personType" : "UNINCORPORATED_FIRM",
      "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
      "salutation" : null,
      "title" : null,
      "givenName" : null,
      "familyName" : null
    },
    "type" : "DEBITOR",
    "mark" : null,
    "contact" : {
      "uuid" : "2f189108-ed7e-4698-88fc-5fc5b29729ef", // Contact: Michelle Matthieu
      "caption" : "Michelle Matthieu",
      "postalAddress" : {
        "zipcode" : "22123",
        "country" : "Germany",
        "city" : "Hamburg",
        "street" : "An der Wandse 34",
        "name" : "Michelle Matthieu"
      },
      "emailAddresses" : {
        "main" : "michelle@matthieu.example.org"
      },
      "phoneNumbers" : {
        "mobile" : "+49 152 1234567"
      }
    }
  },
  "debitorNumber" : "D-3101100",
  "debitorNumberSuffix" : "00",
  "partner" : {
    "uuid" : "3a91c028-722c-48dd-bac9-103112001431", // Partner: P-31011
    "partnerNumber" : "P-31011",
    "partnerRel" : {
      "uuid" : "40c6c87f-3490-42fa-a3f2-fc2fbe748c6f",
      "anchor" : {
        "uuid" : "8f6b2e83-5cd0-4f3b-bac9-c56b374445cf", // Person: Hostsharing eG
        "personType" : "LEGAL_PERSON",
        "tradeName" : "Hostsharing eG",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "holder" : {
        "uuid" : "836d3bb3-2eab-48d1-966e-8916a037816d", // Person: Erbengemeinschaft Michelle Matthieu-Zhang
        "personType" : "UNINCORPORATED_FIRM",
        "tradeName" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "salutation" : null,
        "title" : null,
        "givenName" : null,
        "familyName" : null
      },
      "type" : "PARTNER",
      "mark" : null,
      "contact" : {
        "uuid" : "2b4fbc57-be01-4d73-8a2f-dc60617af612", // Contact: Erbengemeinschaft Michelle Matthieu-Zhang
        "caption" : "Erbengemeinschaft Michelle Matthieu-Zhang",
        "postalAddress" : {
          "zipcode" : "22987",
          "country" : "Germany",
          "city" : "Hamburg",
          "street" : "Im Wischer 14",
          "name" : "Erbengemeinschaft Michelle Matthieu-Zhang",
          "co" : "Lena Stadland",
          "whatever" : "any key is allowed here"
        },
        "emailAddresses" : {
          "main" : "lena.stadland@example.org"
        },
        "phoneNumbers" : {
          "office" : "+49 40 666666"
        }
      }
    },
    "details" : {
      "uuid" : "d1be819c-7338-4af6-9c91-1292df11550e",
      "registrationOffice" : null,
      "registrationNumber" : null,
      "birthName" : "Eichbaum",
      "birthPlace" : "Neustadt a.d.R.",
      "birthday" : "1951-03-25",
      "dateOfDeath" : null
    }
  },
  "billable" : true,
  "vatId" : null,
  "vatCountryCode" : null,
  "vatBusiness" : false,
  "vatReverseCharge" : false,
  "refundBankAccount" : null,
  "defaultPrefix" : "mim"
} ]

generated on 2026-08-10 03:08:34 for branch HEAD